═══ 1. Allgemeines ═══ (DocDate:240496) Willkommen bei GPlan/2 wurde geschaffen, um alle mФglichen Informationen aus VGA-Planets zu sammeln und diese grafisch aufbereitet zu zeigen. Es kann auch die manuellen Arbeiten die bei der Versendung von Zugdateien bzw. beim Empfangen der Auswertungsdatei aus VGA-Planets anfallen, minimieren. Weiterhin werden auf Wunsch alle Daten in ASCII-Dateien gespeichert und stehen fБr Auswertungen zur VerfБgung. Diese Dokumentation beschreibt die Konfiguration von GPlan/2 und grundlegende Vorgehensweisen. Sie erhalten fБr jedes MenБ, jeden MenБpunkt, jeden Einstellungspunkt und jedes Fenster eine erweiterte Hilfe mit der F1-Taste. (c) Copyright 1995-1996 by Percy Stephan, all rights reserved. Das Programm wurde mit HOST Version 3.14, PHOST Version 1.7 und PHOST Version 1.9 getestet. Ob GPlan/2 auch mit anderen HOST- oder PHOST-Versionen arbeitet, kann nicht garantiert werden! ═══ 2. Installation von GPlan/2 ═══ Die Installation von GPlan/2 benФtigt nur sehr wenig Zeit. Sie gliedert sich in zwei Hauptteile: Das Kopieren der benФtigten Dateien und die Оnderung der Konfiguration. In den folgenden Abschnitten wird dies detailiert beschrieben. ═══ 2.1. Arbeitsschritte der Installation ═══ Die Installation von GPlan/2 in Arbeitsschritten: 1. Kopieren Sie die Dateien GPLAN2.EXE, GP2KONF.EXE, GPLAN2.INI, GPLAN2.HLP und GPLAN2.INF in ein Verzeichnis Ihrer Wahl. (NICHT wenn das Installationsprogramm benutzt wurde!) 2. Erstellen Sie eine Kopie der Datei GPLAN2.HLP in dem Verzeichnis \OS2\HELP. Damit ist sichergestellt, daс die Hilfe in jedem Fall gefunden wird. (NICHT wenn das Installationsprogramm benutzt wurde!) 3. Stellen Sie sicher das folgende Programme bei Ihnen installiert wurden:  VPUTIL2.EXE VGA Planets client support utility v3.15 oder neuer, OS/2 32 bits nativ version. Dies muс sich im selben Verzeichnis befinden, in dem auch die VGA-Planets Daten liegen! (c) Copyright 1993-95 Sysma Automatisering.  PLANETS.EXE VGA Planets(tm) Version 3.00, (c) Copyright 1993 Tim Wisseman 4. Stellen Sie sicher, das ihr Host eines der folgenden Programme nutzt:  HOST Version 3.14, PHOST Version 1.7 oder PHOST Version 1.9 Mit diesen wurde GPlan/2 getestet. Ob GPlan/2 auch mit anderen Versionen arbeitet, kann nicht garantiert werden! 5. Erstellen Sie sich ein WPS-Objekt fБr die GPLAN2.EXE und die GP2KONF.EXE (NICHT wenn das Installationsprogramm benutzt wurde!) 6. Starten Sie das Programm 'GPlan/2 Konfiguration' (GP2KONF.EXE) in dem Ordner 'GPlan/2'. 7. Оndern Sie die KonfigurationseintrДge anhand Ihrer BedБrfnisse. (Siehe: Die EintrДge der Konfigurationsdatei GPLAN2.INI) Die Installation ist damit beendet und Sie kФnnen GPlan/2 starten indem Sie in dem Ordner 'GPlan/2' das Symbol 'GPlan/2' anklicken. Allerdings ist diese Installation fБr nur ein Spiel zur Zeit gedacht. Wollen Sie GPlan/2 fБr mehrere Spiele nutzen, sehen Sie unter GPlan/2 fБr mehrere Spiele parallel benutzen nach. ═══ 2.2. GPlan/2 fБr mehrere Spiele parallel benutzen ═══ Um GPlan/2 fБr mehrere Spiele gleichzeitig zu nutzen, mБssen Sie es in einem Verzeichnis Ihrer Wahl installieren (mit oder ohne Installationsprogramm) und fБr jedes Spiel die Dateien GPLAN2.INI und GPLAN2.USR in ein Spieleverzeichnis kopieren. Diese Spieleverzeichnisse mБssen fБr jedes Spiel unterschiedlich sein! Hier ist es also nicht mФglich fБr mehrere Spiele das gleiche Verzeichnis zu wДhlen. Danach lФschen Sie diese beiden Dateien in dem eigentlichen GPlan/2 Verzeichnis und erstellen sich Kopien der GPLAN2.EXE und der GP2KONF.EXE fБr jedes der Spiele. Tragen Sie in dem 'Einstellungs-Notebook' des jeweiligen 'GPLAN/2'- und 'GPlan/2 Konfiguration'-Objekts unter 'Parameter' den Pfad auf das Spieleverzeichnis ein, in dem die GPLAN2.INI und die GPLAN2.USR liegen und unter 'Arbeitsverzeichnis' muс das Verzeichnis stehen, in dem die GPLAN2.EXE bzw. die GP2KONF.EXE liegt. Legen Sie fБr jedes Spiel ein Verzeichnis an, in dem die Informationsdateien und die Datenbanken fБr dieses Spiel abgelegt werden kФnnen. Starten Sie jetzt fБr jedes Spiel die jeweilige GP2KONF.EXE (GPlan/2 Konfiguration) und konfigurieren Sie die benФtigten Einstellungen. Tragen Sie unter 'Allgemein', 'PafdFuerInfoDateien' den Pfad ein, in dem die Informations- und Datenbankdateien abgelegt werden sollen. Wie gesagt, muс dort fБr jedes Spiel ein eigener Pfad eingetragen und vorhanden sein. Ansonsten kommt es zur Katastrophe ;-) Zusammenfassung:  In dem 'Parameter'-Feld der Objekte GPLAN2.EXE und GP2KONF.EXE steht immer der Pfad auf die GPLAN2.INI und GPLAN2.USR mit den Einstellungen fБr dieses Spiel.  Wurde dieses Feld nicht gefБllt, geht GPlan/2 davon aus, daс sich die GPLAN2.INI und GPLAN2.USR im selben Verzeichnis befinden wie die Dateien GPLAN2.EXE/GP2KONF.EXE/GPLAN2.INF/GPLAN2.HLP.  In dem 'Arbeitsverzeichnis'-Feld eines Objekts steht immer der Pfad auf die Dateien GPLAN2.EXE/GP2KONF.EXE/GPLAN2.INF/GPLAN2.HLP.  Die Datei VPUTIL2.EXE muс sich im gleichen Verzeichnis wie die VGA-Planets Daten befinden.  Die Datenbanken und ASCII-Dateien fБr ein Spiel werden in dem Verzeichnis abgelegt, daс in der zugehФrigen Konfiguration unter 'PfadFuerInfoDateien' eingetragen ist. Dieses Verzeichnis muс fБr jedes Spiel unterschiedlich sein.  Die entpackten VGA-Planets Spielerdaten werden in dem Verzeichnis gesucht, daс in der zugehФrigen Konfiguration unter 'PfadAufVGAPlayerData' eingetragen ist.  Die restlichen VGA-Planets Daten werden in dem Verzeichnis gesucht, daс in der zugehФrigen Konfiguration unter 'PfadAufVGAPlan' eingetragen ist. Nun kann GPlan/2 fБr das jeweilige Spiel benutzt werden. Bildliche Darstellung: C:\──┬──GPLAN2 Hier liegen die eigentlichen GPlan/2 Dateien: │ │ GPLAN2.EXE GP2KONF.EXE GPLAN2.INF GPLAN2.HLP │ │ (Diese Dateien sind nur einmal vorhanden, auch wenn die Objekte │ │ mehrmal kopiert wurden) │ │ │ ├─SPIEL1 Verzeichnis fБr die Konfiguration des VGA-Planet Spiels das die Spielerdaten │ │ │ im Verzeichnis C:\VGA_PLAN\S2HELGE entpackt. │ │ │ Hier liegen die GPlan/2-Dateien: GPLAN2.INI und GPLAN2.USR │ │ │ │ │ └─INFODATA Dieses Verzeichnis ist in der Konfiguration unter │ │ 'PfadFuerInfoDateien' eingetragen. Hier liegen die Dateien: │ │ GP*.DBF/GP*.CDX/*.AUS/*.EIN/*.PLA/*.LST usw. │ │ │ ├─SPIEL2 Verzeichnis fБr die Konfiguration des VGA-Planet Spiels das die Spielerdaten │ │ im Verzeichnis C:\VGA_PLAN\S5PETER entpackt. │ │ Dieses Verzeichnis ist auch in der Konfiguration unter │ │ 'PfadFuerInfoDateien' eingetragen. Deshalb liegen hier die Dateien: │ │ GPLAN2.INI/GPLAN2.USR/GP*.DBF/GP*.CDX/*.AUS/*.EIN/*.PLA/*.LST usw. │ │ │ └─SPIEL3 Verzeichnis fБr die Konfiguration des VGA-Planet Spiels das die Spielerdaten │ im Verzeichnis C:\VGA_PLAN\S9HANS entpackt. │ Dieses Verzeichnis ist auch in der Konfiguration unter │ 'PfadFuerInfoDateien' eingetragen. Hier liegen die Dateien: │ GPLAN2.INI GPLAN2.USR GP*.DBF GP*.CDX usw. │ │ └─ VGA_PLAN Hier liegen die eigentlichen VGA-Planets Dateien. Um nur manche zu nennen: │ PLANET.NM BEAMSPEC.DAT HULLSPEC.DAT ENGSPEC.DAT RESOURCE.PLN usw. │ Die Datei VPUTIL2.EXE befindet sich auch hier! │ ├─S2HELGE Hier liegen die entpackten RST-Dateien fБr das zweite Spiel bei 'Helge' │ in dem wir die Cyborgs vertreten. Z.B. liegt hier: │ BDATA6.DAT BDATA6.DIS MDATA6.DAT MDATA6.DIS SHIP6.DAT SHIP6.DIS usw. │ ├─S5PETER Hier liegen die entpackten RST-Dateien fБr das fБnfte Spiel bei 'Peter' │ in dem wir die Fed's vertreten. Z.B. liegt hier: │ BDATA1.DAT BDATA1.DIS MDATA1.DAT MDATA1.DIS SHIP1.DAT SHIP1.DIS usw. │ └─S9HANS Hier liegen die entpackten RST-Dateien fБr das neunte Spiel bei 'Hans' in dem wir die Rebels vertreten. Z.B. liegt hier: BDATA10.DAT BDATA10.DIS MDATA10.DAT MDATA10.DIS SHIP10.DAT SHIP10.DIS usw. Hinweis: Bei der Installation von Updates mБssen Sie evtl. manuell eingreifen... Lesen Sie in diesem Fall die Datei "WHATSNEW.TXT". Dort erhalten Sie dann Hinweise auf durchgefБhrte Оnderungen. ═══ 2.3. Konfiguration Abschnitt 'Allgemein'. ═══ Folgende EintrДge werden in der Konfiguration Gruppe 'Allgemein' abgefragt: Allgemein Format der Netmail Bildschirm ist auf... Planeten in der Historie Schiffe in der Historie Anzahl der Flugstrecken InfoDateien erstellen fБr PfadFuerInfoDateien Alternative Farboption ═══ 2.3.1. Allgemein ═══ In dieser Gruppe werden die Einstellungen vorgenommen, die fБr alle Konfigurationsgruppen gelten. ═══ 2.3.2. Format der Netmail ═══ Format der Netmail Hier wДhlen Sie das Format fБr die ausgehende E-Mail. Sie kФnnen zwischen dem Squish(tm)-Format und dem Msg-Format wДhlen. Wenn Sie keinen der beiden Punkte markieren, wird auch keine Netmail erstellt. Aber die Zugdatei wird erstellt, gesichert und kopiert! Sollten Sie nicht wissen, welches Format Ihr Mailer unterstБtzt, sehen Sie sich die Mailer-Dokumentation an. ═══ 2.3.3. Bildschirm ist auf ... ═══ Bildschirm ist auf ... Aktivieren Sie hier den entsprechenden Punkt. Es wird dann innerhalb der Dialoge eine angepaсte Schrift gezeigt. ═══ 2.3.4. Planeten in der Historie ═══ Anzahl der Runden fБr die Planeten in der Historie behalten werden sollen Hier kФnnen Sie bestimmen, Бber wieviel Runden Planetendaten in der Historie behalten werden. Steht hier zum Beispiel '20' und Sie befinden sich mit dem Spiel in Runde 119, so werden alle Planetendaten in der Historie gelФscht, die Дlter als Runde 99 sind. Bei Planeten spielt diese Einstellung keine allzu groсe Rolle, da nicht alle Historiedaten in den Speicher geladen werden, sondern erst wenn sie benФtigt werden. Hinweis: Steht hier eine '0', kФnnen Sie beim 'extrahieren von Informationen' erheblich Zeit sparen, da damit eine Schleife ausgeschaltet wird die ansonsten alle DatensДtze auf ihr Alter prБft. Es bedeutet auch, daс alle Daten aus allen Runden in der Historie behalten werden. ═══ 2.3.5. Schiffe in der Historie ═══ Anzahl der Runden fБr die Schiffe in der Historie behalten werden sollen Hier kФnnen Sie bestimmen, Бber wieviel Runden Schiffsdaten in der Historie behalten werden. Steht hier zum Beispiel '20' und Sie befinden sich mit dem Spiel in Runde 119, so werden alle Schiffsdaten in der Historie gelФscht, die Дlter als Runde 99 sind. Diese Einstellung spielt eine groсe Rolle, da bei dem Laden der globalen Daten alle Historiedaten durchsucht werden um die Schiffswege in den Speicher einzulesen. Und dies beansprucht 80% der Ladezeit von GPlan/2. Hinweis: Steht hier eine '0', kФnnen Sie beim 'extrahieren von Informationen' erheblich Zeit sparen, da damit eine Schleife ausgeschaltet wird die ansonsten alle DatensДtze auf ihr Alter prБft. Es bedeutet auch, daс alle Daten aus allen Runden in der Historie behalten werden. Und damit auch das o.a. Einlesen sehr lange dauert... ═══ 2.3.6. Anzahl der Flugstrecken ═══ Anzahl der Runden zur Anzeige der Flugstrecken Hier kФnnen Sie bestimmen, Бber wieviel Runden die Flugstrecke von Schiffen auf der groсen Karte angezeigt werden sollen. Dies sind maximal 20 aber es kann schon sehr unБbersichtlich sein die Flugstrecken Бber 20 Runden zu verfolgen. Daher kann hier ein kleinerer Wert eingegeben werden. Hinweis: Dieser Wert spielt, zeitlich gesehen, keine Rolle. ═══ 2.3.7. Info-Dateien erstellen fБr ═══ Info-Dateien erstellen fБr Hier kФnnen Sie auswДhlen, welche der Informationsarten in lesbare ASCII-Textdateien extrahiert werden sollen. Um den Inhalt dieser Dateien zu sehen: LST-Dateien EIN-Dateien AUS-Dateien PLA-Dateien SIP-Dateien Die Datenbank-Dateien (*.DBF) werden immer unabhДngig von diesen Einstellungen gefБllt. ═══ 2.3.8. PfadFuerInfoDateien ═══ PfadFuerInfoDateien Hier geben Sie einen Pfad ein, in dem die durch GPlan/2 erstellten Dateien mit den jeweiligen Informationen, abgelegt werden sollen. Siehe auch: LST-Dateien EIN-Dateien AUS-Dateien PLA-Dateien SIP-Dateien Datenbank-Dateien Beispiel: C:\PLANETS\MESS ═══ 2.3.9. Alternative Farboption ═══ Wenn dieser Punkt aktiviert wurde, wird immer eine feste Farbe fБr die jeweilige Rasse in der groсen Karte verwendet. Diese Farben sind kФnnen in dem Dialog 'Kartenparametern/Farben Дndern' eingestellt werden. ═══ 2.4. Konfiguration Abschnitt 'Konfig'. ═══ Folgende EintrДge werden in der Konfiguration Gruppe 'Konfig' abgefragt: Konfig CfgVersion SpielNummer Rasse PfadAufVGAPlan PfadAufVGAPlayerData PfadAufDASIZugDatei PfadFuerZugDateiAusgabe PfadAufEingehendeAuswertungen PfadAufDASIAuswertungen to de fr ad ar at Spezielle Dateinamen ═══ 2.4.1. Konfig ═══ Konfig Konfig stellt die eigentliche Konfigurationsgruppe dar. Siehe auch: (GPlan/2 fБr mehrere Spiele parallel benutzen) ═══ 2.4.2. CfgVersion ═══ CfgVersion Dieser Eintrag soll als Hilfe dienen, die jeweiligen Spiele zuzuordnen. Der Inhalt wird in der unteren Statuszeile in runden Klammern gezeigt. Beispiel: S2inPERCYsBOX ═══ 2.4.3. SpielNummer ═══ SpielNummer Dieser Eintrag ist nur fБr die Zusammenstellung der Dateinamen bei eingehenden Auswertungen und ausgehenden Zugdateien erforderlich. Anhand dieses Eintrages wird unterschieden, fБr welches laufende Spiel die entsprechende Datei ist. DER EINTRAG DARF NUR EINE STELLE HABEN! Und muс auch bei Verwendung der normalen Dateinamen angegeben werden. Beispiel: 2 ═══ 2.4.4. Rasse ═══ Rasse Hier steht die Rassennummer fБr das entsprechende Spiel. Geben Sie hier nur Zahlen ein und nicht 'A', 'a', 'B' oder 'b' fБr die Rassen 10 und 11! Beispiel: 11 ═══ 2.4.5. PfadAufVGAPlan ═══ PfadAufVGAPlan Hier geben Sie den vollstДndigen Pfad auf die Dateien von VGA-Planets ein. Nicht zu verwechseln mit dem Pfad auf die Spielerdateien, obwohl beide im selben Pfad liegen kФnnen... Beispiel: D:\VGA_PLAN ═══ 2.4.6. PfadAufVGAPlayerData ═══ PfadAufVGAPlayerData Hier geben Sie den vollstДndigen Pfad auf die Spielerdateien von VGA-Planets ein. Der Pfad kann mit dem Pfad auf die VGA-Planets Dateien identisch sein. In diesem Pfad mБssen sich die Datei befinden, die erstellt werden wenn eine PLAYERnn.RST entpackt wird. Beispiel: D:\VGA_PLAN\SPIEL2 ═══ 2.4.7. PfadAufDASIZugDatei ═══ PfadAufDASIZugDatei Durch GPlan/2 wird automatisch eine Sicherungskopie der Zugdatei angelegt. Hier geben Sie den vollstДndigen Pfad ein, in dem diese Sicherungskopie abgelegt werden soll. Beispiel: D:\VGA_PLAN\TRN_OUT ═══ 2.4.8. PfadFuerZugDateiAusgabe ═══ PfadFuerZugDateiAusgabe Hier geben Sie einen vollstДndigen Pfad an, in dem GPlan/2 die fertige Zugdatei zur Versendung ablegen soll. Beispiel: D:\MAILER\MAIL\OUTFILES ═══ 2.4.9. PfadAufEingehendeAuswertungen ═══ PfadAufEingehendeAuswertungen Hier geben Sie einen oder mehrere vollstДndige Pfade an, in dem GPlan/2 nach eingehenden Auswertungen suchen soll. Mehrere Pfade trennen Sie durch ein ';'. GPlan/2 durchsucht jeden der angegebenen Pfade nach der aktuellen Auswertung, wobei die Auswertung einen entsprechenden Dateinamen haben muс. Wird eine solche Datei gefunden, wird sie bearbeitet. (Siehe auch Aktionen bei Auswertungen) Beispiel: D:\MAILER\MAIL\INKNOWN;D:\MAILER\MAIL\INPROT ═══ 2.4.10. PfadAufDASIAuswertungen ═══ PfadAufDASIAuswertungen Hier geben Sie einen vollstДndigen Pfad ein, in dem GPlan/2 eine Sicherungskopie der Auswertungsdatei ablegen soll. (Siehe auch Aktionen bei Auswertungen) Beispiel: D:\VGA_PLAN\RST_IN ═══ 2.4.11. to ═══ to Hier geben Sie den EmpfДngernamen fБr die automatisch erstellte Mail ein. Dieser sollte in der Regel Ihr VGA-Planets Host sein. Beispiel: Andreas Gaertner ═══ 2.4.12. de ═══ de Hier geben Sie die EmpfДngeradresse fБr die automatisch erstellte Mail ein. In der Regel ist das die Adresse Ihres VGA-Planets Host. Also derjenige, der diese Spielrunde leitet und die Auswertungen erstellt. Beispiel: 2:240/6101.19 ═══ 2.4.13. fr ═══ fr Hier geben Sie Ihren Absender-Namen fБr die automatisch erstellte Mail ein. Beispiel: Percy Stephan ═══ 2.4.14. ad ═══ ad Hier geben Sie Ihre Netz-Adresse fБr die automatisch erstellte Mail ein. Beispiel: 2:240/6105.12 ═══ 2.4.15. ar ═══ ar Hier geben Sie den Namen der Area ein, in der die automatisch erstellte Mail eingetragen wird. Die Area muс bereits vorhanden sein! Dies sollte in der Regel Ihre NETMAIL-Area sein. Beispiel: D:\MAILER\AREAS\NETMAIL ═══ 2.4.16. at ═══ at Hier geben Sie die Attribute fБr die automatisch erstellte Mail ein. Dies sollte in der Regel 'Private', 'Local' und 'Direct' sein. Folgende Flags werden unterstБtzt:  Private  Local  Crash  Direct  Hold Trennen Sie die Flags durch ein ','! Das Flag 'File-Attach' wird automatisch gesetzt. Beispiel: Private,Local,Crash ═══ 2.4.17. Spezielle Dateinamen fБr die TRN- und RST-Dateien verwenden. ═══ Spezielle Dateinamen fБr die TRN- und RST-Dateien verwenden. Hier kФnnen Sie entscheiden, ob Sie die besseren speziellen Dateinamen verwenden wollen oder die normalen. Die speziellen (SnrrZnnn.) haben den Vorteil, daс anhand Ihres Dateinamens schon erkannt werden kann fБr welches SPIEL, RASSE und aus welcher RUNDE sie stammen. Auch kФnnen damit bestimmte Probleme behoben werden, die auftreten wenn Sie Ihre ZБge an den Host per eMail abgeben und dort noch eine alte normale (PLAYERnn.) Datei liegt. Dann wird u.U. die neue umbenannt und sie wird von dem Host nicht mehr anerkannt. Markieren Sie diesen Punkt, wenn Sie die speziellen Dateinamen benutzen wollen. Damit Бbernimmt GPlan/2 die Kontrolle Бber die ein- und ausgehenden Dateien. Wenn Sie diesen Punkt nicht markieren, mБssen Sie sich um die Dateien kБmmern! D.h. Sie mБssen immer darauf achten, daс die richtige Datei in dem Eingangsverzeichnis liegt und nicht irgend eine alte... ═══ 2.5. Konfiguration Abschnitt 'Programme'. ═══ Folgende EintrДge werden in der Konfiguration Gruppe 'Programme' abgefragt: Programm Beispiele Titel Programm Parameter Startverzeichnis ═══ 2.5.1. Programm Beispiele ═══ In dieser Gruppe kФnnen Sie die vier Programme festlegen, die Бber den MenБpunkt 'Programme starten' ausgefБhrt werden. Beispiel 1: Titel: BinkleyTerm Mailer Programm: D:\OS2\CMD.EXE Parameter: /C D:\MAILER\BINK\B_TASK1.CMD Startverz.: D:\MAILER\BINK Beispiel 2: Titel: VPUtil/2 MenБ Programm: D:\VGA_PLAN\VPUTIL2.EXE Parameter: mm -p11 -pwPASSWORT -wS2PETER Startverz.: D:\VGA_PLAN Beispiel 3: Titel: DOS-Session im Fenster Programm: D:\OS2\MDOS\COMMAND.COM Parameter: [LEER] Startverz.: [LEER] Beispiel 4: Titel: ShipCalc++ im DOS-Gesamtbildschirm Programm: D:\VGA_PLAN\SHIPCALC.EXE Parameter: [LEER] Startverz.: D:\VGA_PLAN ═══ 2.5.2. Titel ═══ Hier geben Sie den jeweiligen Programmitel ein, der im MenБ unter 'Programme starten' gezeigt werden soll. Beispiel: VPUtil/2 MenБ ═══ 2.5.3. Programm ═══ Hier geben Sie den Dateinamen des zu startenden Programms mit vollstДndigem Pfad ein. Beispiel: D:\VGA_PLAN\VPUTIL2.EXE ═══ 2.5.4. Parameter ═══ Diese EintrДge werden dem jeweiligen Programm als Parameter Бbergeben. Beispiel: mm -p11 -pwPASSWORT -wS2PETER ═══ 2.5.5. Startverzeichnis ═══ Hier geben Sie das Startverzeichnis fБr das jeweilige Programm ein. Wenn Sie keines benФtigen, lassen Sie diesen Eintrag leer. Beispiel: D:\VGA_PLAN ═══ 3. Dateien, Daten und Aktionen ═══ In diesem Kapitel werden Ihnen die Datendateien und dessen Aufbau, sowie die einzelnen Aktionen vorgestellt bzw. beschrieben. ═══ 3.1. Die Script-Datei GPlan2.USR ═══ Die Script-Datei GPlan2.USR Damit Sie auch eigene Daten in die groсe Karte einzeichnen kФnnen, wurde diese MФglichkeit geschaffen. Die Dateien mБssen sich im gleichen Verzeichnis wie die Бbrigen GPlan/2-Dateien befinden. Die Anzahl der Zeilen ist nur durch den verfБgbaren Speicher begrenzt. Steht ein Semikolon ';' am Anfang einer Zeile, wird diese nicht ausgewertet. Z.Zt. gibt es fБnf Eintragstypen, die im folgenden erklДrt werden:  Linie: VonX=[NWert] VonY=[NWert] ZuX=[NWert] ZuY=[NWert] Farbe=[FWert] Dicke=[DWert] Art=[AWert] Mit diesem Eintragstyp wird eine Linie von der 'Von'-Position zur 'Zu'-Position gezeichnet. [NWert] steht fБr die jeweilige Koordinate auf der Karte [FWert] steht fБr die gewБnschte Farbe. (Farben siehe unten) [DWert] steht fБr 1=schmale Linie 2=breitere Linie [AWert] steht fБr die Linienart. (Arten siehe unten)  Kreis: MitteX=[NWert] MitteY=[NWert] Radius=[RWert] Farbe=[FWert] Dicke=[DWert] Art=[AWert] Mit diesem Eintragstyp wird um der 'Mitte'-Position ein Kreis mit dem angegebenem Radius gezeichnet. [NWert] steht fБr die jeweilige Koordinate auf der Karte [RWert] steht fБr den gewБnschten Radius und muс kleiner 256 sein. [FWert] steht fБr die gewБnschte Farbe. (Farben siehe unten) [DWert] steht fБr 1=schmale Linie 2=breitere Linie [AWert] steht fБr die Linienart. (Arten siehe unten)  Text: VonX=[NWert] VonY=[NWert] Text=[Text] Farbe=[FWert] Mit diesem Eintragstyp wird an der 'Von'-Position der angegebene Text gezeichnet. Die LinienstДrke, Schrifttyp und SchriftgrФсe sind dabei fest vorgegeben. Die TextlДnge darf 255 Stellen NICHT Бberschreiten! [NWert] steht fБr die jeweilige Koordinate auf der Karte [Text] steht fБr den gewБnschten Text, der immer in gesperrt gezeigt wird. [FWert] steht fБr die gewБnschte Farbe. (Farben siehe unten)  Box: MitteX=[NWert] MitteY=[NWert] Seiten=[SWert] Farbe=[FWert] Dicke=[DWert] Ecken=[EWert] Art=[AWert] Mit diesem Eintragstyp wird um der 'Mitte'-Position eine Box mit den angegebenen SeitenlДngen gezeichnet. [NWert] steht fБr die jeweilige Koordinate auf der Karte [SWert] steht fБr die gewБnschte SeitenlДnge. [FWert] steht fБr die gewБnschte Farbe. (Farben siehe unten) [DWert] steht fБr 1=schmale Linie 2=breitere Linie [EWert] steht fБr die Rundung der Ecken. '0' bedeutet keine Rundung der Ecken. [AWert] steht fБr die Linienart. (Arten siehe unten)  Dreieck: MitteX=[NWert] MitteY=[NWert] Hoch=[HWert] Farbe=[FWert] Dicke=[DWert] Art=[AWert] Mit diesem Eintragstyp wird um der 'Mitte'-Position ein Dreieck mit der angegebenen HФhe gezeichnet. [NWert] steht fБr die jeweilige Koordinate auf der Karte [HWert] steht fБr die HФhe des Dreiecks. [FWert] steht fБr die gewБnschte Farbe. (Farben siehe unten) [DWert] steht fБr 1=schmale Linie 2=breitere Linie [AWert] steht fБr die Linienart. (Arten siehe unten) Die folgenden Farbwerte kФnnen (in Klein- oder Groсbuchstaben) vergeben werden:  BLUE █████  RED █████  PINK █████  GREEN █████  CYAN █████  YELLOW █████  BROWN █████  DARKGRAY █████  DARKBLUE █████  DARKRED █████  DARKPINK █████  DARKGREEN █████  DARKCYAN █████  PALEGRAY █████  BLACK █████ Die folgenden Linienarten kФnnen vergeben werden: 1 SOLID 2 DOT 3 SHORTDASH 4 LONGDASH 5 DOUBLEDOT 6 DASHDOT 7 DASHDOUBLEDOT (Kein Eintrag) SOLID Beispiel fБr den Inhalt einer GPLAN2.USR-Datei: ; Hier einige Beispiele fБr die Script-Datei ; Linie: VonX=1000 VonY=1000 ZuX=1500 ZuY=1500 Farbe=Green Dicke=1 Kreis: MitteX=1100 MitteY=1100 Radius=100 Farbe=RED Dicke=1 Text: VonX=1300 VonY=1300 Text=Percy Farbe=YELLOW Box: MitteX=1500 MitteY=1500 Seiten=100 Farbe=BlUe Dicke=2 Ecken=0 Dreieck: MitteX=1200 MitteY=1400 Hoch=100 Farbe=pink Dicke=1 Linie: VonX=1500 VonY=1000 ZuX=1500 ZuY=1500 Farbe=Green Dicke=1 Art=1 Linie: VonX=1550 VonY=1000 ZuX=1550 ZuY=1500 Farbe=Green Dicke=1 Art=2 Linie: VonX=1600 VonY=1000 ZuX=1600 ZuY=1500 Farbe=Green Dicke=1 Art=3 Linie: VonX=1650 VonY=1000 ZuX=1650 ZuY=1500 Farbe=Green Dicke=1 Art=4 Linie: VonX=1700 VonY=1000 ZuX=1700 ZuY=1500 Farbe=Green Dicke=1 Art=5 Linie: VonX=1750 VonY=1000 ZuX=1750 ZuY=1500 Farbe=Green Dicke=1 Art=6 Linie: VonX=1800 VonY=1000 ZuX=1800 ZuY=1500 Farbe=Green Dicke=1 Art=7 ═══ 3.2. Aufbau der Dateinamen (.TRN-, .RST-, .LST-, .EIN-, .AUS-, .SIP- und .PLA-Dateien) ═══ In der Konfigurationen kФnnen Sie zwischen speziellen und normalen Dateinamen wДhlen! Bei den speziellen Dateinamen wird folgende Zusammenstellung vorausgesetzt: ┌────────┬──────┬────────────────────────────────────────┐ │LДnge │Inhalt│Beschreibung │ │ │Art │ │ ├────────┼──────┼────────────────────────────────────────┤ │1 │S │fБr die Einleitung der SpielNummer │ ├────────┼──────┼────────────────────────────────────────┤ │1 │n │Spielnummer │ ├────────┼──────┼────────────────────────────────────────┤ │1 ggf. 2│n ggf.│Nummer der Rasse │ │ │nn │ │ ├────────┼──────┼────────────────────────────────────────┤ │1 │Z │fБr die Einleitung der Zug bzw. │ │ │ │Rundennummer │ ├────────┼──────┼────────────────────────────────────────┤ │3 │nnn │Rundennummer in num. Form ohne fБhrende │ │ │ │Nullen │ └────────┴──────┴────────────────────────────────────────┘ Beispiel: Ausgehende Zugdatei im Spiel 2 Runde 8 der Rasse 11: s211z8.trn Eingehende Auswertung im Spiel 6 Runde 116 der Rasse 8: s68z116.rst Datei mit den Informationen Бber Ihre Planeten aus Spiel 3, Runde 22, Rasse 5: s35z22.pla ═══ 3.3. Inhalte der InfoDateien ═══ Im folgenden werden Ihnen die Inhalte der Informationsdateien, die Sie unter dem MenБpunkt 'Aktionen/Informationen extrahieren' erstellen, gezeigt. Diese Informationsdateien bestehen aus reinem ASCII-Text. Sie haben nichts mit den Datenbankdateien zu tun. Die Erstellung der jeweiligen Datei hДngt von der Einstellung in der Konfiguration ab! ═══ 3.3.1. Punktedatei *.LST ═══ Diese Dateien enthalten eine Liste der Rassen in Verbindung mit der Anzahl ihrer Raumschiffe, Planeten und Sternenbasen. Sie werden Бber den MenБpunkt 'Aktionen/Infomationen extrahieren' erstellt. Welche Art von Dateien Sie wБnschen, kann in der Konfiguration eingestellt werden! Beispiel: Runde 101 Die Rassen in der Ъbersicht: The Solar Federation 0 0 0 0 The Lizard Alliance 0 1 0 0 The Empire of the Birds 0 2 2 4 The Fascist Empire 5 55 16 23 The Privateer Bands 0 0 0 0 The Cyborg 7 33 108 7 The Crystal Confederation 5 40 24 16 The Evil Empire 19 205 102 42 The Robotic Imperium 0 1 2 0 The Rebel Confederation 2 4 8 5 The Missing Colonies of Man 18 127 103 27 │ │ │ │ Starbases────────────────────────┘ │ │ │ │ │ │ Planets───────────────────────────────┘ │ │ │ │ Capital Ships──────────────────────────────┘ │ │ Freighters──────────────────────────────────────┘ ═══ 3.3.2. Eingehende Nachrichten *.EIN ═══ Diese Dateien enthalten die jeweiligen eingehenden Nachrichten. Sie werden Бber den MenБpunkt 'Aktionen/Infomationen extrahieren' erstellt. Welche Art von Dateien Sie wБnschen, kann in der Konfiguration eingestellt werden! Beispiel: <<< Sub Space Message >>> FROM : The Missing Colonies of Man TO : The Missing Colonies of Man <<< Universal Message >>> An: Die Bewohner der Sternenbasis auf Rappaport! Wir bedauern Ihnen mitteilen zu mБssen, daс sich Ihr Planet in einer geplanten Hyperwarptrasse der MCoM befindet. Da dies nicht mit unseren Sicherheits- richtlinien zu vereinbaren ist, sehen wir uns gezwungen Ihren Planeten zu beseitigen. Black Adder, Leiter der Verkehrswege- planung MCoM. << Deep Space Scanner Report >> We have detected a massive meteor impact on The planet: Murphrid 432 ( planet ID number 15 ) Based on the resulting explosion the virtual neutrino spectrometers show meteor ore content to be: 9604 kt Neutronium 1257 kt Duranium 6508 kt Tritanium 4654 kt Molybdenum ═══ 3.3.3. Ausgehenden Nachrichten *.AUS ═══ Diese Dateien enthalten die jeweiligen ausgehenden Nachrichten. Sie werden Бber den MenБpunkt 'Aktionen/Infomationen extrahieren' erstellt. Welche Art von Dateien Sie wБnschen, kann in der Konfiguration eingestellt werden! Beispiel: From: The Missing Colonies of Man To: The Missing Colonies of Man Dies ist ein Testtext fБr die Erstellung der ausgehenden Nachrichten unter GPlan/2... Black Adder ═══ 3.3.4. Planeteninformationen *.PLA ═══ Diese Dateien enthalten alle Informationen Ihrer Planeten: Sie werden Бber den MenБpunkt 'Aktionen/Infomationen extrahieren' erstellt. Welche Art von Dateien Sie wБnschen, kann in der Konfiguration eingestellt werden! Beispiel: ────────────────────────────────────────────────────────────────────── #128 Canes Delta FC: --- Temp: 67 Rasse: 11 ────────────────────────────────────────────────────────────────────── MINERALIEN: Neutronium Tritanium Duranium Molybdenum Auf der OberflДche: 1704 4739 3409 5964 Noch im Boden.....: 4 2 2 2 Ertragsrate.......: 77 31 31 35 INDUSTRIE UND WIRTSCHAFTSGЪTER: Minen Fabriken Supplies MegaKredite 240 159 3722 29867 BEWOHNER: Kolonisten: Ureinwohner: Anzahl: 352300 Anzahl: 7561200 Stimmung: 100% Stimmung: 100% Steuersatz: 0% Steuersatz: 4% Einnahme: 0MC Einnahme: 302MC Rasse: Humanoid (TL10 Hulls) Staatsform: Feudal (100%) PLANETARE VERTEIDIGUNG: Verteidigungsanlagen: 109 = Laserwaffen.......: 6 Heavy Blaster (TL6) = Startrampen.......: 10 = JДger.............: 10 ═══ 3.3.5. Schiffsinformationen *.SIP ═══ Diese Dateien enthalten Informationen Бber Schiffe: Sie werden Бber den MenБpunkt 'Aktionen/Infomationen extrahieren' erstellt. Welche Art von Dateien Sie wБnschen, kann in der Konfiguration eingestellt werden! ═══ 3.4. Datenbank-Dateien (GP*.DBF) ═══ Die Daten aus den VGA-Planets Dateien, werden in verschiedene DBF-Dateien geschrieben und die SchlБsselwerte in verschiedene CDX-Dateien. Die Dateinamen: PLANETEN-DATEN: GPPDATA.DBF = EnthДlt die jeweils aktuellen Planetendaten GPPDATA.CDX = EnthДlt den Index dieser Datei GPPHIST.DBF = EnthДlt alle Planetendaten als Historie GPPHIST.CDX = EnthДlt den Index dieser Datei GPPDATA.B?? = Backup-Datei der GPPDATA.DBF und .CDX GPPHIST.B?? = Backup-Datei der GPPHIST.DBF und .CDX SCHIFFS-DATEN: GPSHIP.DBF = EnthДlt die jeweils aktuellen Schiffsdaten GPSHIP.CDX = EnthДlt den Index dieser Datei GPSHIST.DBF = EnthДlt alle Schiffsdaten als Historie GPSHIST.CDX = EnthДlt den Index dieser Datei GPSHIP.B?? = Backup-Datei der GPSHIP.DBF und .CDX GPSHIST.B?? = Backup-Datei der GPSHIST.DBF und .CDX MINENFELDER-DATEN: GPMINES.DBF = EnthДlt die jeweils aktuellen Minenfelddaten GPMINES.CDX = EnthДlt den Index dieser Datei GPMINES.B?? = Backup-Datei der GPMINES.DBF und .CDX NACHRICHTEN-DATEN: GPMAIL.DBF = EnthДlt alle Nachrichten. GPMAIL.CDX = EnthДlt den Index dieser Datei GPMAIL.B?? = Backup-Datei der GPMAIL.DBF und .CDX SCHIFFS-MEMODATEN: GPSINFO.DBF = EnthДlt alle Memo's GPSINFO.CDX = EnthДlt den Index dieser Datei GPSINFO.B?? = Backup-Datei der GPSINFO.DBF und .CDX WURMLOCH-DATEN: WH.LOG = EnthДlt alle gescannten WurmlФcher mit den EintrДgen [LfdNr]#[X-Position]#[Y-Position]#[Masse]#[Aus Runde]# WH.BAK = Die Дltere Datei WH.LOG WHSCRIPT.USR = EnthДlt alle WurmlФcher mit der StabilitДt '1' und '2' aus der WH.LOG aber fБr die Ъbernahme in die GPLAN2.USR aufbereitet. ═══ 3.5. Auswertungsdateien ═══ Auswertungen sind die Dateien, die Sie von Ihrem VGA-Planets Host erhalten. Sie stellen den Stand der Daten dar, wie er nach der Auswertung Ihrer ZБge durch das Host-Programm ist. Auch mБssen Sie vor der Verwendung mit VGA-Planets mit VPUtil2.exe entpackt werden, damit die Daten auch von dem Programm Planets.exe gelesen werden kФnnen. Auswertungen haben IMMER die Dateiendung .RST und nach der Bearbeitung mit GPlan/2 einen Dateinamen PLAYERn, wobei n fБr die jeweilige Rasse steht. ═══ 3.6. Zugdateien ═══ Zugdateien werden erstellt, in dem sie mit VPUtil2.exe gepackt werden. Sie sollten erst gepackt werden, wenn Sie Ihre ZБge mit Planets.exe getДtigt haben. Diese Zugdateien werden dem VGA-Planets Host Бbermittelt, der mit diesen Zugdateien den Auswertungslauf startet. Zugdateien haben IMMER die Dateiendung .TRN und vor der Bearbeitung mit GPlan/2 einen Dateinamen PLAYERn, wobei n fБr die jeweilige Rasse steht. Nach der Bearbeitung haben Sie den entsprechenden Dateinamen. ═══ 3.7. Aktionen bei Auswertungen ═══  Bei eingehenden Auswertungen prБft GPlan/2 die aktuelle Runde und sucht in den angegebenen Pfaden nach einer Auswertung mit dieser aktuellen Runde.  Wird eine Datei (mit dem entsprechenden Dateinamen und der Dateiendung .RST) gefunden, legt GPlan/2 eine Sicherungskopie der Datei an  Verschiebt die eingegangene Datei in das entsprechende VGA-Planets Spielerdaten-Verzeichnis  Dort wird sie mit VPUtil2 entpackt  Der MenБpunkt 'Informationen extrahieren' wird ausgefБhrt ═══ 3.8. Aktionen bei Zugdateien ═══  Bei ausgehenden ZБgen ruft GPlan/2 das Programm VPUtil2 auf um die Zugdatei PLAYERn.TRN zu erstellen.  Aus dieser Datei generiert GPlan/2 eine Datei mit dem entsprechendem Dateinamen und der Dateiendung TRN.  GPlan/2 legt eine Sicherungskopie der Datei an und kopiert die Zugdatei in das Ausgangsverzeichnis.  Die temporДre Datei im VGA-Planets Verzeichnis wird gelФscht.  Die MsgAPI wird aufgerufen um die E-Mail zum versenden der Datei zu generieren.  Die ausgehenden Nachrichten werden in die Datenbank geschrieben ═══ 3.9. Rundennummer/Zugnummer ═══ Die Zug- oder auch Rundennummer genannte Zahl, wird aus der zum VGA-Planets gehФrenden Datei GENn.DAT gelesen. (n steht fБr die Rassennummer) ═══ 4. Darstellungen in GPlan/2 ═══ Hier wird die Darstellung von Objekten innerhalb der groсen Karte in GPlan/2 gezeigt: Ein eigenes Schiff das z.Zt. nicht angewДhlt wurde. Fremde Schiffe und ihre Flugrichtung mit einigen Planeten. Der Punkt 'FR_Alle' ist aktiviert und die Flugrichtung des einen Schiffes wird durch die gelbe Linie gezeigt. Das andere bleibt auf der Stelle oder hat seinen Wegpunkt erreicht. Beide Schiffe wurden nicht angewДhlt. (Ansonsten wБrde mindestens die Schiffsnummer und -name gezeigt.) Eine Explosion, dargestellt durch das rote Viereck und weitere fremde Schiffe und Planeten. Ein Planet. Ein Planet und ein Minenfeld mit der ID #38 Eine Sternenbasis. Auf diesem Planeten sind alle Mineralien und Geldmittel vorhanden um eine Sternenbasis zu bauen. Ein fremdes, gewДhltes Schiff und ein gewДhlter Planet mit 'FB-Tracing = ON'. Das gewДhlte Schiff mit der Nummer #226 und dem Namen 'ESS BETON' fliegt mit Warp 9 in die Richtung der gelben Linie. Die bekannte Flugstrecke wird mit einer durchgezogenen Linie und die unbekannte Flugstrecke mit einer gestrichelten Linie gezeigt. Um den Planeten mit der Nummer #275 und dem Namen 'Shaw' werden normale Warpkreise gezeigt. Ein eigenes, nicht gewДhltes Schiff das dem HБllentyp entspricht, der in den Kartenparameter Seite 'S2' eingestellt wurde. Dargestellt durch die von der Schiffsposition nach oben gezeichneten Punktlinie. Dieses Schiff befindet sich auf einem eigenen Planeten. Und ein weiteres eigenes Schiff auf einem eigenen Planeten. Auch dieses Schiff ist nicht gewДhlt worden. Bei dem linken Bild ist die 'alternative Farbe' aktiviert und den verschiedenen Rassen verschiedene Farben zugewiesen worden.(GRAU=Unbekannte Planeten, alle anderen Objekte haben die Farbe der jeweiligen Rasse.) Bei dem rechten Bild sind die 'alternativen Farben' NICHT aktiviert worden und fБr eine Rasse ist die Verfolgung angeschaltet. (GRAU=unbekannte Schiffe oder Schiffe der nicht verfolgten Rassen sowie unbekannte Planeten oder Planeten der nicht verfolgten Rassen, GELB=Eigene Schiffe, GRЪN=Eigene Planeten, ROT=Schiffe der verfolgten Rasse, VIOLETT=Planeten der verfolgten Rasse) Bei diesen beiden Bildern wird der Vorteil der 'alternativen Farben' gezeigt. Im linken Bild kann man sofort erkennen, welches Objekt zu welcher Rasse gehФrt und wie deren Verbreitung ist. ═══ 5. Bemerkungen zu GPlan/2 ═══ Dieses Kapitel enthДlt einige Bemerkungen Бber den Einsatz von GPlan/2, ohne dabei eine bestimmte Reihenfolge zu beachten. ═══ 5.1. Die Belegung der Maustasten ═══ Folgende Maustastenbelegungen gelten: In der groсen Karte: Klick auf die linke Maustaste Im Sticky-Modus wird ihnen das nДchstgelegene Objekt markiert. Sind mehrere Objekte an dieser Position, wird ein Auswahldialog gezeigt. Im Koordinaten-Modus wird ihnen die Koordinate markiert und mit den Zahlen gezeigt. SHIFT-Taste und Klick auf die linke Maustaste Im Sticky-Modus wird ihnen das nДchstgelegene Objekt markiert. Sind mehrere Objekte an dieser Position, wird ein Auswahldialog gezeigt. Wurde ein Schiff gewДhlt, wird Ihnen ein Dialog gezeigt indem Sie Memo's zu diesem Schiff eintragen und speichern kФnnen. Klick auf die rechte Maustaste Der Mittelpunkt der Karte wird die Mauszeigerposition. D.h. die Karte wird so verschoben, daс das Fadenkreuz in der Mitte auf die neue Position rБckt. Doppelklick mit der linken Maustaste Im Sticky-Modus wird ihnen das nДchstgelegene Objekt markiert und ein Dialog mit genauen Daten des Objektes angezeigt. Sind mehrere Objekte an dieser Position, wird ein Auswahldialog gezeigt. Im Koordinaten-Modus passiert nichts. In der ZoomBox-Karte: Klick auf die rechte Maustaste Der Mittelpunkt der groсen Karte wird die Mauszeigerposition. D.h. die Karte wird so verschoben, daс das Fadenkreuz in der Mitte auf die neue Position rБckt, die in der ZoomBox markiert wurde. In Dialogen mit Daten in Tabellenform: Klick auf die linke Maustaste Die Zeile wird markiert. Klick auf die rechte Maustaste Es wird Ihnen ein PopupmenБ geezeigt, in dem Sie weitere Einstellungen fБr die Tabelle vornehmen kФnnen. ═══ 5.2. AktualitДt der angezeigten Daten. ═══ Die angezeigten Daten von GPlan/2 sind, bis auf die ein- und ausgehenden Nachrichten, immer aus den Datenbanken. D.h. sie werden erst aktualisiert, wenn Sie den MenБpunkt 'Informationen extrahieren' wДhlen. Nur dann werden die neusten Daten aus VGA-Planets eingelesen und in die GPlan/2 Datenbanken gestellt. Allerdings wird dieser Punkt auch automatisch nach Eingang einer Auswertungsdatei ausgefБhrt. Dies bedeutet nun, daс Sie die Daten Бber das Programm 'Planets.exe' Дndern und in GPlan/2 immer noch die Daten gezeigt werden, wie sie vor dieser Оnderung waren. Wir sind bei der Entwicklung von GPlan/2 davon ausgegangen, daс die ZБge (mit der Planets.exe) parallel zu den Informationen von GPlan/2 erstellt werden. Man also zwischen Planets und GPlan/2 hin- und herschaltet und damit sowieso nicht immer die neusten Daten benФtigt. Oder? ═══ 5.3. HyperwarpsprБnge berechnen. ═══ GPlan/2 berechnet Ihnen einen Sprungpunkt und zeigt diesen in dem Hinweisfenster, unter den folgenden UmstДnden: 1. Der Punkt 'FB-Tracing' ist bei den Kartenparametern markiert. 2. Der Sticky-Modus ist aktiviert. 3. Sie haben ein Hyperwarpschiff angeklickt und es wird Ihnen angezeigt. 4. Sie haben danach einen Planeten angeklickt. Dann wird Ihnen im Hinweisfenster ein Sprungpunkt 'HY =' gezeigt, den Sie in VGA-Planets eingeben kФnnen. Ein 'kleiner' Nachteil des GPlan/2 Design ist, daс Sie nur ein Schiff zur Zeit markieren kФnnen. Damit ist es nicht mФglich ein zweites Schiff als Sprungziel zu wДhlen. Allerdings kФnnen Sie sich helfen, indem Sie dann auf den Koordinaten- Modus umschalten und einen in der Flugbahn befindlichen Punkt anklicken. Die Anzeige in der groсen Karte (Der Punkt 'Alternative Farben' wurde nicht aktiviert) Die Meldung im Hinweisfenster ═══ 5.4. Minenfeldhilfe ═══ GPlan/2 berechnet Ihnen die benФtigte Anzahl von Minen fБr einen bestimmten Radius unter den folgenden UmstДnden: 1. Der Punkt 'Entfernungen messen' ist bei den Kartenparametern markiert. 2. Sie haben eine 'VON'-Position angeklickt. 3. Sie haben danach eine 'BIS'-Position angeklickt. Dann wird Ihnen im Hinweisfenster eine Meldung 'EN =' gezeigt, in der die Entfernung zwischen diesen beiden Punkten gezeigt wird. Unter dieser Meldung befindet sich jetzt ein Hinweis fБr die Torpedos. Dabei wird angenommen, daс Sie an der 'VON'-Position eine Minenfeld mit dem Radius bis zu der 'BIS'-Position anlegen wollen. Es werden alle TechLevel fБr Torpedos und die fБr diesen TechLevel benФtigte Torpedomenge gezeigt. ═══ 5.5. Langsame Festplatten und die GPlan/2 Datenbanken. ═══ Die Geschwindigkeit mit der GPlan/2 die Daten zur Anzeige aus den Datenbanken einliest, hДngt sehr von der Geschwindigkeit der verwendeten Festplatte und (natБrlich) von dem verwendeten Computersystem. Zum Programmstart werden bei vollem Ship-Slot insgesamt mindestens 12000 DatensДtze in den Speicher eingelesen. Zu Testzwecken habe ich GPlan/2 einmal auf einer Quantum 1GB Fireball SCSI-II und einaml von einer Дlteren Quantum PD1050iS SCSI-II Festplatte gestartet. Der Zeitunterschied ist gewaltig... Die benФtigte Zeit um die Informationen aus VGA-Planets zu extrahieren steigt mit der Anzahl der in der Schiffs-Historie vorhanden DatensДtze. Damit dies von jedem Anwender gesteuert werden kann, besteht die MФglichkeit in der Konfiguration die Anzahl der in der Schiffs-Historie gespeicherten Runden zu begrenzen. 80% der Zeit die GPlan/2 benФtigt um die 'globalen Daten' einzulesen werden gebraucht um die Flugbahnen von Raumschiffen festzustellen. Und diese werden fБr maximal 20 Runden eingelesen (Der Max.-Wert ist fest vorgegeben). Daher ist es angebracht die oben angesprochene Einstellung in der Konfiguration auf 20 Runden zu stellen. Damit muс GPlan/2 bei vollem Ship-Slot 20 x 500 = 10000 DatensДtze einlesen. DafБr ist dann aber alles im Speicher und es werden keine weiteren Dateizugriffe benФtigt. ═══ 5.6. GrundsДtzliche Arbeitsweise von GPlan/2. ═══ GPlan/2 ist in vier Fenster aufgeteilt. Dies sind: Das Hauptfenster mit der MenБzeile und der groсen Karte Das Hinweisfenster in dem die Hinweise und Fehlermeldungen gezeigt werden Das Kartenparameterfenster in dem die Einstellungen fБr die groсe Karte vorgenommen werden Das ZoomBox-Fenster mit dem sichtbaren Ausschnitt der groсen Karte Alle Fenster sind in der OS/2-Fensterliste enthalten, sofern sie aktiv sind. Sollten Sie eines der Fenster geschlossen haben und wollen es erneut anzeigen lassen, so kФnnen Sie das entsprechende Fenster Бber den MenБpunkt 'Fenster' aufrufen. Alle mФglichen Programmodule wurden als sogenannte Threads programmiert. Damit wird erreicht, daс diese Module nur dann OS/2 Rechenzeit benФtigen wenn sie auch irgend etwas abarbeiten mБssen. Den Rest der Zeit 'schlafen' sie und benФtigen sehr wenig Rechenleistung. D.h. Sie mБssen die Fenster, die Sie z.Zt. nicht benФtigen nicht schlieсen um Rechenleistung zu sparen. Wenn Sie GPlan/2 starten werden die Fenster immer so gezeigt, wie sie beim letzten Beenden von GPlan/2 gezeigt wurden. Alle nФtigen Daten werden in den Speicher geladen und in der groсen Karte wird der Echo-Cluster des VGA-Planets Universums gezeigt. Alles andere ist von den Einstellungen in dem Kartenparameter-Fenster abhДngig. Sie kФnnen jetzt alle vorhandenen Informationen mit den entsprechenden Maustasten abrufen. ═══ 5.7. Besonderheiten von GPlan/2. ═══  Echtes OS/2 PM-Programm  Alles 32-Bit Code  Arbeitet mit mehreren Threads  BenutzerunterstБtzung durch erweiterte Hilfe Бber die F1-Taste  Datenbanken im xBASE Format  EnthДlt Datenbanken fБr die Historie von Planeten und Schiffen  Zu jedem Schiff kann der Benutzer einen Memo-Text speichern.  Planetendaten kФnnen manuell geДndert oder neu angelegt werden  EnthДlt Datenbanken fБr die ein- und ausgehenden Nachrichten  EnthДlt eine editierbare Datenbank fБr die Minenfelder  Anzeige der Flugstrecke Бber max. 20 Runden  Anzeige von Schiffen die irgendwann mal sichtbar waren  Anzeige von Resourcen in der groсen Karte.  Fast alle Schriftarten, -grФсen und Farben per Drag'n Drop frei wДhlbar  Alle Programmtexte in deutscher Sprache  RST- und TRN-Dateien kФnnen bearbeitet werden  Verbesserte Dateinamen fБr RST- und TRN-Dateien  Es kann die eMail zur Versendung der TRN-Dateien erstellt werden  Flexible Script-Datei fБr eigene Eintragungen in der groсen Karte  Viele Daten in Tabellenform mit Sortier- und Filterfunktionen  Eine Minenfeldhilfe wird angezeigt  Eine Hyperwarphilfe wird angezeigt  OS/2 Installationsprogramm mit Versionskontrolle und LФschfunktion in der Reg.-Version  Gibt es noch mehr??? ═══ 6. Lizenzbestimmungen allgemein ═══ GPlan/2 ist in der unregistrierten Version Shareware, d.h. der Anwender darf das Programmpaket kostenlos weiterverteilen und eine gewisse Zeit (4 Wochen) testen. Nach Ablauf des Testzeitraums von 4 Wochen, muс der Anwender das Programm entweder beim Autor registrieren wenn er/sie es weiter verwenden will oder es von seinen DatentrДgern entfernen. (Es gilt der Abschnitt "Nutzungslizenz und GewДhrleistung der Shareware Version von 'GPlan/2'") Mit der Registrierung erhДlt der Anwender einen Code und eine Seriennummer in einem sogenannten 'KeyFile'. Damit werden alle EinschrДnkungen etc. der unregistrierten Version aufgehoben. Diese Version von GPlan/2 ist dann eine registrierte Version und keine Shareware mehr. (Es kommt der "Lizenzvertrag fБr die registrierte Version von 'GPlan/2'" zur Anwendung.) Die RegistrierungsgebБhr betrДgt 30 DM und gilt fБr die aktuelle Version 1.xx und alle folgenden Оnderungen innerhalb der Version 1.xx ═══ 6.1. Nutzungslizenz und GewДhrleistung der Shareware Version von 'GPlan/2' ═══ Nutzungslizenz und GewДhrleistung fБr die Shareware (unregistrierte) Version von 'GPlan/2' (c) Copyright 1995-1996 by Percy Stephan, alle Rechte vorbehalten. Der Begriff Programm bezieht sich auf alle ausfБhrbaren Programme des Programmpakets 'GPlan/2' und alle Dokumentations-Dateien. Das Programm steht unter urheberrechtlichem Schutz durch die Urheber- und Handels-Gesetze des Landes, in dem es genutzt, vervielfДltigt bzw. verФffentlicht wird. Der Autor Percy Stephan hat das Urheberrecht an dem Programm 'GPlan/2' und erlaubt die Benutzung, die VervielfДltigung und VerФffentlichung ausschliesslich unter der Voraussetzung, daс die nachfolgenden Lizenzbedingungen erfБllt sind und anerkannt werden: Garantie / GewДhrleistung / Haftung: Absolut keine. Zur Klarstellung: DER AUTOR UND SEINE MITARBEITER HAFTEN NICHT FЪR SCHОDEN JEGLICHER ART, INSBESONDERE NICHT FЪR VERMЩGENSSCHОDEN, SACHSCHОDEN, ENTSTANDENE VERBINDLICHKEITEN GEGENЪBER DRITTEN UND SCHОDEN, DIE AUS FEHLFUNKTIONEN DES PROGRAMMS ODER AUFGRUND VON BEDIENUNGSFEHLERN ENTSTEHEN. DIES BEINHALTET - IST ABER NICHT BESCHRОNKT AUF - JEDE FORM VON UNTERBRECHUNG EINES SERVICE, GESCHОFTSVERLUSTE, FOLGESCHОDEN ODER ANDERE NACHTEILE, DIE AUS DER BENUTZUNG DES PROGRAMMS ENTSTEHEN. IN STAATEN, IN DENEN DIESER TOTALE GEWОHRLEISTUNGS- UND HAFTUNGSAUSSCHLUSS NICHT ERLAUBT IST, IST DIE BENUTZUNG VON 'GPlan/2' NICHT ERLAUBT. Nutzungs-Lizenz: Das Programm wird herausgegeben, wie es ist, und darf in der unregistrierten Version unter BerБcksichtigung der nachfolgenden EinschrДnkungen frei benutzt werden. Es darf vervielfДltigt, verФffentlicht und verbreitet werden, unter der Bedingung, daс keine GebБhr fБr die Nutzung, Verteilung, VerФffentlichung, Verbreitung oder VervielfДltigung erhoben wird und das Programm in unmodifizierter Form, wie es von dem Autor zur VerfБgung gestellt wird, weitergegeben wird. Die kostenlose Nutzung des Programms ist auf 4 Wochen beschrДnkt. Danach ist der Nutzer dazu verpflichtet entweder die Nutzung zu unterlassen oder eine Nutzungslizenz an 'GPlan/2' zu erwerben. 'GPlan/2' darf nicht zur Entwicklung von Konkurrenzprodukten verwendet werden. Die Benutzung dieses Programms stellt eine Einwilligung in diese Lizenz als ganzes dar und die Freistellung des Autor und seiner Mitarbeiter von jeglicher Verantwortung und Haftung. Der Nutzer erklДrt sein EinverstДndnis in den Ausschluss des Rechtweges. Rechte Dritter: Die 'GPlan/2' Dokumentation und zugehФrigen Dateien benennen einige Produkte Dritter. Alle Urheberrechte, Warenzeichen und sonstige Rechte werden hiermit anerkannt. ═══ 6.2. Lizenzbestimmungen der registrierten Version von 'GPlan/2' ═══ Lizenzvertrag fБr die registrierte Version von 'GPlan/2' Die Benutzung des Computerprogrammpaketes 'GPlan/2', nachfolgend als "Software" bezeichnet, erfolgt in der registrierten Version ausschlieсlich zu den nachbenannten Bedingungen. Der Endverbraucher erkennt mit dem Einsatz des Programmpaketes die nachstehenden Vertragsbedingungen als verbindlich an. Es kommt damit zwischen Ihnen, dem Lizenznehmer, und dem Herrn Percy Stephan Lerchenweg 39 21397 Barendorf als Lizenzgeber, der nachfolgende Lizenzvertrag zustande: 1. Vertragsgegenstand: Gegenstand des Vertrages ist das auf dem DatentrДger (Diskette) aufgezeichnete Computerprogrammpaket "GPlan/2", einschlieсlich Programmbeschreibung, Bedienungsanleitung und sonstiger Dokumentationen sowie eventuell vorhandener Hilfsprogramme. Der Lizenznehmer erkennt an, daс es nach dem Stand der Technik nicht mФglich ist, Computer-Software so zu erstellen, daс sie in allen Anwendungen und Kombinationen fehlerfrei arbeitet. 2. Umfang der Benutzung: Der Lizenzgeber gewДhren dem Lizenznehmer fБr die Dauer des vorliegenden Vertrages ein einfaches, nicht ausschliesliches und persФnliches Recht, das Programmpaket 'GPlan/2' auf einem einzelnen Computer, d.h. auf nur einem, mit einer einzigen Zentraleinheit (CPU) und nur an einem Ort, zu nutzen. Jede weitergehende Nutzung ist nicht gestattet. 3. Besondere BeschrДnkungen: Dem Lizenznehmer ist es insbesondere untersagt, 1. das Softwarepaket oder einzelne Programmteile an Dritte weiterzugeben oder einem Dritten sonstwie zugДnglich zu machen, inbesondere in Form der Leihe oder Miete, 2. die Software Бber ein Netz oder einen DatenБbertragungskanal von einem Computer auf einen anderen Computer zu Бbertragen, 3. die Software abzuДndern, zu Бbersetzen, zurБckzuentwickeln, zu entkompilieren, oder entassemblieren, 4. abgeleitete Werke zu erstellen, 4. Inhaberschaft an Rechten: Der Lizenznehmer erhДlt durch den Erwerb des Programmpaketes allein das Eigentum an dem kФrperlichen DatentrДger. Ein Erwerb von Rechten an der Software ist mit der VerДuсerung des die Software enthaltenden DatentrДgers nicht verbunden. VerФffentlichungs, VervielfДltigungs, Bearbeitungs- und Verwertungsrechte an der Software behДlt sich der Lizenzgeber vor. 5. VervielfДltigung: Die Software ist urheberrechtlich zugunsten des Lizenzgebers geschБtzt. Das Anfertigen einer (einzigen) Reservekopie ist nur zu Sicherungszwecken zulДssig. Alle Urheberrechts- und sonstige in der Software befindlichen Vermerke wie Registriernummern und Hinweise auf den Lizenznehmer dБrfen nicht entfernt werden. Jede weitere Einbringung in andere Software jeglicher Art wird dem Lizenznehmer untersagt. 6. Dauer des Vertrages: Der Vertrag ist zeitlich nicht befristet. Jede Zuwiderhandlung des Lizenznehmers gegen die Lizenzbestimmungen verwirkt das Nutzungsrecht, ohne daс es seitens des Lizenzgebers einer KБndigung bedarf. 7. Schadensersatz bei Vertragsverletzung: Der Lizenznehmer haftet fБr alle VermФgensschДden, die dem Lizenzgeber aufgrund von Verletzungen des Urheberrechts oder Verletzung dieser Vertragsbestimmungen entstehen. 8. Оnderungen und Aktualisierungen: Der Lizenzgeber ist berechtigt, die Software nach eigenem Ermessen zu aktualisieren. Er ist nicht verpflichtet, dem Lizenznehmer etwaige Aktualisierungen zur VerfБgung zu stellen. 9. GewДhrleistung: 1. Der Lizenzgeber gewДhrleistet zum Zeitpunkt der Ъbergabe die einwandfreie Lesbarkeit des DatentrДger, auf dem die Software aufgezeichnet ist, soweit dieser unter normalen Betriebsbedingungen und bei normaler Instandhaltung der Datenverarbeitungsanlage eingesetzt wird. 2. Der Lizenzgeber Бbernimmt keine Haftung fБr die Fehlerfreiheit der Software, insbesondere nicht dafБr, daс die Software den Anforderungen und Zwecken des Erwerbers genБgt oder mit anderen von ihm ausgewДhlten Programmen zusammenarbeitet. 3. Der Lizenzgeber haftet nicht fБr SchДden, es sei denn, daс diese durch Vorsatz oder grobe FahrlДssigkeit herbeigefБhrt worden sind. Soweit der Lizenznehmer Kaufmann i.S. des Handelsgesetzbuches ist, wird auch die Haftung fБr grobe FahrlДssigkeit ausgeschlossen. Eine Haftung fБr zugesicherte Eigenschaften bleibt unberБhrt. Die Haftung aus einer abgegebenen Zusicherung erstreckt sich nicht auf MangelfolgeschДden, die nicht von der Zusicherung umfasst sind. 4. Ist der Lizenznehmer Vollkaufmann, gilt als Gerichtsstand LБneburg vereinbart. ═══ 7. EinschrДnkungen der unregistrierten GPlan/2 Version ═══ Die Daten in der Historie sind auf ZWEI Runden beschrДnkt. Beim Programmstart erscheint ein Hinweisfenster. ═══ 8. Registrierung von GPlan/2 ═══ ====================================================================================== Registrierung von GPlan/2 Hiermit mФchte ich eine Lizenz fБr das Programmpaket GPlan/2 erwerben. Name: ________________________________________________________________ Strasse: _____________________________________________________________ PLZ: ___________ Stadt: _____________________________________________ Telefon (voice): _____________________________________________________ Land: ________________________________________________________________ eMail Adresse: _______________________________________________________ Das Programm soll registriert werden auf: Eintrag in der Form: Vorname NAME, Ort (EMail-Adresse) Beispiel: Percy STEPHAN, Barendorf (2:240/6105.12) ______________________________________________________________________ Die Bezahlung der RegistrierungsgebБhr (30 DM) erfolgt: [ ] per Ъberweisung [ ] per Verrechnungsscheck (liegt bei) [ ] Bar (liegt bei) Die neuste Version von GPlan/2, die BestДtigung und der Registrierungscode werden per Briefpost, Adresse wie oben, auf 3,5" Disketten versendet. Alle Angaben werden vertraulich behandelt und nicht weitergegeben. Anregungen und Hinweise zur Verbesserung sind immer Willkommen. Datum, Unterschrift: ____________ , ___________________________________ ====================================================================================== Das ausgefБllte Bestell-Formular schicken Sie bitte * per Briefpost an Percy STEPHAN Lerchenweg 39 21397 BARENDORF * per FAX an 04137-810022 (ISDN) * per Fido-Mail an 2:240/6105.12@fido (PER Crash!) Ъberweisungen richten Sie bitte an: Percy STEPHAN Konto 2010 5144 Sparkasse LБneburg, BLZ 240 501 10 Verwendungszweck: GPlan/2 Bestellung ═══ 9. Copyrights / Trademarks ═══ Folgende Namen sind in gewissen LДndern Warenzeichen oder Dienstleistungsnamen der IBM Corporation: IBM Operating System/2 OS/2 OS/2 ArbeitsoberflДche PrДsentations-Manager SAA Weitere Warenzeichen: C++ ist ein Warenzeichen der American Telephone and Telegraph Company. Intel ist ein Warenzeichen der Intel Corporation. CodeBase ist ein Warenzeichen der Sequiter Software Inc. dBASE ist ein Warenzeichen von Borland International Die 'GPlan/2' Dokumentation und zugehФrigen Dateien benennen einige Produkte Dritter. Alle Urheberrechte, Warenzeichen und sonstige Rechte werden hiermit anerkannt. ═══ 9.1. Planets.exe ═══ PLANETS.EXE VGA Planets(tm) Programm um die SpielzБge zu erstellen. (c) Copyright 1993 Tim Wisseman VGA Planets is a trademark of Tim Wisseman. VGA Planets ist ein grafisch unterstБtztes Kriegsspiel fБr mehrere Spieler, welches einen Kampf zwischen mehreren galaktischen Imperien im Weltall simuliert. Die Hauptaspekte des Spieles sind RohstoffФrderung, Kolonisierung und die Konstruktion von Raum- schiffen. Die Spieler wetteifern miteinander in wirtschaftlichen und militДrischen Aspekten von galaktischen Ausmaсen. VGA Planets kann mit einem Schachspiel fБr 11 Spieler ver- glichen werden, in dem alle Spieler alle ihre Figuren gleichzeitig ziehen, immer eine Runde nach der anderen. ═══ 9.2. VPUtil2.exe ═══ VPUTIL2.EXE VGA Planets client support utility, OS/2 32 bits nativ version. (c) Copyright 1993-95 Sysma Automatisering. This utility is designed to support and enhance the client part of the game VGA Planets versions 3.0 only (ie. Planets.Exe). VGA Planets is a strategic space war/economy simulation game for up to eleven players. The unique feature of the game is that it plays the turns off-line. This means that there is a game server (or Host) somewhere where the entire game universe exists. The game server executes the commands the players provide each game turn and provides the results, tailored to every player. ═══ 9.3. PHOST ═══ PHOST THE PORTABLE HOST (C) 1995 by the program authors: Andrew Sterian, Thomas Voigt, Steffen Pietsch and Matt Mueller. What is The Portable Host ? =========================== The Portable Host (PHOST) is a complete replacement for the HOST 3.15 program that is supplied with VGA Planets. VGA Planets is a play-by-email game for the IBM PC written by Tim Wisseman. The PHOST program was designed to emulate the original HOST program in as many ways as possible. ═══ 9.4. Squish (tm) ═══ Squish (tm) GPlan/2 nutzt die 'Squish Message Base Level 0 MsgAPI Library' Maximus and Squish are trademarks of SCI Communications. ═══ 10. Fehlermeldungen ═══ Soweit mФglich, werden alle Fehlermeldungen in dem 'GPlan/2 Hinweisfenster' gezeigt. Diese Meldungen sollten dem Anwender den genauen Fehlergrund mitteilen. Allerdings sind manche Fehlermeldungen nur fБr den Autor gedacht. Sollten Sie also mit einer Fehlermeldung nichts anfangen kФnnen und die Meldung erscheint immer wieder, teilen Sie diese dem Autor per Fax oder eMail, unter Angabe Ihrer benutzten GPlan/2 Version und der UmstДnde die zu diesem Fehler fБhrten, mit. ═══ 11. Aktionen bei Fehlern ═══ Soweit mФglich, werden alle Fehlermeldungen in dem 'GPlan/2 Hinweisfenster' gezeigt. Diese Meldungen sollten dem Anwender den genauen Fehlergrund mitteilen. Handeln Sie entsprechend dieser Meldung. VerhДlt sich GPlan/2 merkwБrdig, beenden Sie GPlan/2 und starten Sie es erneut. Ist der Fehler dann immer noch vorhanden, starten Sie den MenБpunkt: DATEN/ALLE GELЩSCHTEN DATENSОTZE ENTFERNEN (PACK). Danach starten Sie den MenБpunkt: DATEN/ALLE INDEXDATEIEN NEU AUFBAUEN (REINDEX) Ist der Fehler nach diesen Schritten immer noch vorhanden, starten Sie den MenБpunkt: DATEN/DATEN DER AKTUELLEN RUNDE LЩSCHEN. Dieser MenБpunkt lФscht alle Daten der aktuellen Runde um evtl. doppelt vorhandene Daten zu entfernen. Nachdem dieser fertig ist, starten Sie den MenБpunkt: DATEN/INFORMATIONEN EXTRAHIEREN. Sollte der Fehler immer noch vorhanden sein, wenden Sie sich per Fax oder eMail an den Autor. ═══ 12. Verwendete Programme ═══ GPlan/2 wurde mit folgenden Programmen erstellt und getestet:  IBM VisualAge C++ for OS/2 V3.0 (C-Modus)  Squish(tm) Message Base Level 0 MsgAPI Library  CodeBase(tm) C-Bibliothek fБr die Datenbankverwaltung, Version 5.1  HeD/2 Hex Editor for OS/2  EDITINI Simple Profile Editor for OS/2, Version 1.11  VGA-Planets HOST Version 3.14  VGA-Planets HOST Version 3.15  PHOST Version 1.7  PHOST Version 1.9  u.v.a. Die UnterstБtzung fБr den Host 3.2 ist geplant... ═══ 13. Danksagungen ═══ Die folgenden Personen haben zur Entstehung und Verbesserung von GPlan/2 beigetragen: Helge BETH (2:240/5458.2) - Beta-Tester und er hat viele Verbesserungen angeregt. Andreas GAERTNER (2:240/6101.19) - Beta-Tester Volker BЩSPFLUG - Beta-Tester Gerhard FRIEDERICH - Beta-Tester Marco KRAUSE - Beta-Tester